# Ranks Details

> `GET /api/academy/ranks/{rank_id}`: Academy endpoint of the Rone Arena API.

Retrieve details for a specific rank in Mobile Legends: Bang Bang by rank ID. Supports query parameter for localization.

Path parameters:
- **rank_id**: Rank ID (validated dynamically from current rank list). Minimum: 1, Maximum: 9999.

Query parameters:
- **lang**: Language code for localized content (default: `en`).

The response includes detailed rank data:
- **records**: Array of rank entries, each containing:
    - **_id**: Unique record identifier.
    - **configId**: Configuration ID.
    - **caption**: Localized caption (e.g., '236-9999荣耀神话').
    - **createdAt**: Creation timestamp.
    - **createdUser**: Creator username.
    - **updatedAt**: Last update timestamp.
    - **updatedUser**: Last updater username.
    - **data**:
        - **bigrank**: Major rank ID (e.g., 7).
        - **bigrank_name**: Major rank name (e.g., '荣耀神话').
        - **icon**: Rank icon URL.
        - **rankid_start**: Starting rank ID in the range.
        - **rankid_end**: Ending rank ID in the range.
    - **id**: Internal record ID.
    - **linkId**: Linked object references.
    - **sort**: Sorting index.

This endpoint is useful for:
- Displaying detailed information about a single rank tier.
- Explaining its position in the progression system.
- Guiding players in understanding the game's ranking structure.

## Request

`GET https://arena.rone.dev/api/academy/ranks/{rank_id}`

### Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `rank_id` | path | integer | yes |  | Rank ID. Maximum is validated dynamically from current rank list. Range: 1..9999. |
| `lang` | query | string | no | `en` | Language code for localized content. One of: `en`, `id`, `ru`, `es`, `pt`, `tr`, `ar`, `de`, `fr`, `it`, `ja`, `ko`, `th`, `vi`, `zh-CN`, `zh-TW`, `km`. |

### Example

```bash
curl -X GET 'https://arena.rone.dev/api/academy/ranks/{rank_id}'
```

## Example response

```json
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "6908a30ee594c8676a88ed08",
        "configId": 144237,
        "id": 3210567,
        "caption": "236-9999\u8363\u8000\u795e\u8bdd",
        "data": {
          "_object": 3210429,
          "bigrank": 7,
          "bigrank_name": "\u8363\u8000\u795e\u8bdd",
          "icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F191257b84f57be74430d1964c4b01c8b.png",
          "rankid_end": 9999,
          "rankid_start": 236
        },
        "createdUser": "v_xyxu",
        "createdAt": 1762173710344,
        "updatedAt": 1762173748966,
        "updatedUser": "v_xyxu",
        "linkId": [
          3210429
        ],
        "sort": 0
      }
    ],
    "total": 1
  }
}
```

## Links

- Try it in the playground: https://arena.rone.dev/web/academy/ranks/{rank_id}
- Academy endpoints: https://arena.rone.dev/web/academy.md
- OpenAPI schema: https://arena.rone.dev/api/openapi.json